---
title: clsClaimTaskCollection
summary: API reference for clsClaimTaskCollection.
status: draft
owner: SAIF Documentation
last_reviewed: 2026-08-21
library: SAIF.Business.Tasks.Claim
reference_type: embedded
---

# clsClaimTaskCollection

`clsClaimTaskCollection` is the plain filtered-retrieval collection for claim tasks — it constrains retrieval to `CLAIM`-source rows and provides the default date/priority sort used across claim-task list views.

## Purpose
- Retrieves claim tasks matching a filter, delegating to the inherited dynamic `TASK` query ([Retrieve a filtered claim task list](../../operations/op-5-retrieve-filtered-claim-task-list.md)).
- Materializes each retrieved row as a `clsClaimTask` via the overridden `NewTask()` factory.
- Provides a default sort (`TaskDate` then `PriorityCode`) callers can apply after retrieval.

## Context
- Namespace: `SAIF.Business.Tasks.Claim`
- Assembly/package: `SAIF.Business.Tasks.Claim.dll` (embedded)

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `FilterClaimNum` | `Public Property FilterClaimNum As String` | Echoes the claim-number filter used for the retrieval that populated this collection. |
| `FilterStartDate` | `Public Property FilterStartDate As Date` | Echoes the start-date filter used for retrieval. |
| `FilterEndDate` | `Public Property FilterEndDate As Date` | Echoes the end-date filter used for retrieval. |
| `Add(clsClaimTask)` | `Public Overloads Sub Add(task As clsClaimTask)` | Adds a claim task to the collection. |
| `Item(Integer)` | `Public Default ReadOnly Property Item(index As Integer) As clsClaimTask` | Returns the task at the given ordinal position. |
| `Item(taskSeqNum As String)` | `Public Overloads ReadOnly Property Item(taskSeqNum As String) As clsClaimTask` | Returns the task matching the given task sequence number. |
| `ItemByGuid(guid)` | `Public Function ItemByGuid(guid As Guid) As clsClaimTask` | Returns the task matching the given GUID identity. |
| `SortByDefault()` | `Public Sub SortByDefault()` | Sorts the collection by `TaskDate` then `PriorityCode` ascending. |
| `Shared NewTaskCollection(dpi)` | `Public Shared Function NewTaskCollection(dpi As IDataPortalInfo) As clsClaimTaskCollection` | Factory that creates an empty claim-task collection bound to the data portal. |
| `Shared GetTasks(dpi, ClaimTaskCriteria)` | `Public Shared Function GetTasks(dpi As IDataPortalInfo, criteria As ClaimTaskCriteria) As clsClaimTaskCollection` | Retrieves a filtered claim-task collection ([Retrieve a filtered claim task list](../../operations/op-5-retrieve-filtered-claim-task-list.md)). |
| `Overrides NewTask()` | `Protected Overrides Function NewTask() As iTask` | Returns a new `clsClaimTask` instance, used by the inherited retrieve materialization logic. |

## Inherited public members

Members in this section are inherited from `clsTaskCollection` in `SAIF.Business.Tasks`. They are available on this type through inheritance.

| Member | Signature | Purpose | Origin |
| --- | --- | --- | --- |
| `Count` | `Public ReadOnly Property Count As Integer` | Returns the number of tasks currently held in the collection.† | `SAIF.Business.Tasks` — `clsTaskCollection` |
| `IsValid` | `Public Overrides ReadOnly Property IsValid As Boolean` | Aggregates validity across every contained task, used by save/validate flows.† | `SAIF.Business.Tasks` — `clsTaskCollection` |
| `Save()` | `Public Overridable Function Save() As clsTaskCollection` | Applies edits and persists each contained task through the inherited stored-procedure path.† | `SAIF.Business.Tasks` — `clsTaskCollection` |

## Behavioral notes
- `ClaimTaskCriteria` — parameterless constructor sets inner/outer sort ascending on date + priority; DPI constructor sets priority sort descending.*

## Constraints and usage notes
- Every task materialized through this collection carries `SourceSystem = TaskSourceSystem.Claims` per [BR-CT-11](../../business-rules.md#br-ct-11-claim-tasks-always-report-claims-source-system).

> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts. Statements
> marked with ** could not be confirmed; treat as unknown until verified. Statements marked with
> † were retrieved from dependency library documentation via the Legends CLI RAG service. They
> describe inherited behavior from the indicated origin library and should be verified if the
> dependency version changes.

## Sources
- SAIF.Business.Tasks.Claim/clsClaimTaskCollection.vb